home *** CD-ROM | disk | FTP | other *** search
/ STraTOS 1997 April & May / STraTOS 1 - 1997 April & May.iso / CD01 / INTERNET / BROWSERS / WWW131 / FINGER / FINGER.DOC next >
Encoding:
Text File  |  1996-05-27  |  6.4 KB  |  199 lines
  1. Finger
  2. Version 1.00
  3. Coded by Lonny Pursell
  4. (C)1996 by Lonny Pursell and ENCOM
  5. All rights reserved.
  6.  
  7. ** Documentation **
  8.  
  9. See 'Support' for contacts, credits, and future additions.
  10. See 'Revision History' for a complete list of changes.
  11.  
  12.  
  13. Introduction
  14. ------------
  15. What is Finger?  It's a client program designed to work with the
  16. STiK internet software.  It allows you to check e-mail addresses,
  17. get more detailed information on an account, check your own
  18. account for waiting e-mail, search for other users, and more.
  19.  
  20.  
  21. Disclaimer
  22. ----------
  23. Use this software completely at your own risk.
  24. That pretty much says it all.  8^)
  25.  
  26.  
  27. Program Requirements
  28. --------------------
  29. STiK should be loaded and enabled and on-line
  30. at least a resolution of 640x200
  31. some free disk space on your system
  32.  
  33.  
  34. Installation
  35. ------------
  36. Place FINGER.PRG anywhere you like as it doesn't matter what
  37. drive you execute it form.
  38.  
  39.  
  40. Setup Notes
  41. -----------
  42. The server line should be set to your DNS (dynamic name server),
  43. this would be the same as your 'NAMESERVER=' in the STiK config
  44. file.
  45.  
  46. Due to the way in which the finger protocol works there is no way
  47. to predict how much data will be received from the server.  To get
  48. around this the data is dumped to disk into a temporary file and
  49. read back in for display.  I suggest setting the 'Cache' path to
  50. the same path used for CAB this way no errors should occur.  The
  51. temporary file is deleted after being read back in.  The cache
  52. path should be a full path with a trailing backslash.  Example:
  53. 'E:\CAB\CACHE\'  If the trailing backslash is left out the
  54. program will add it.  If the cache path is left blank it will
  55. send the data to the default path when the program was started.
  56.  
  57. Once you have these set, save the configuration.
  58.  
  59.  
  60. Controls
  61. --------
  62. Input:
  63.   Finger  e-mail address or name to query server for
  64.   Server  your DNS server name goes here
  65.   Cache   drive path for incoming finger data with some free space
  66.  
  67. Buttons:
  68.   Info    credits
  69.   Save    save program configuration to disk
  70.   Print   send finger data to line printer
  71.   Finger  start the server query
  72.   Exit    exit the program
  73.  
  74. Arrows:
  75.   use the arrows to scroll through the finger data that is returned
  76.   double-click the up arrow to jump to the top 
  77.   double-click the down arrow to jump to the bottom
  78.  
  79. ESCape key: Aborts the server query.
  80.  
  81.  
  82. Example Finger Commands
  83. -----------------------
  84. I'll use my own account as an example.  The single qoutes should
  85. _not_ be typed as they are included only to highlight the actual
  86. data that should be entered.
  87.  
  88. To finger my own account:
  89.  
  90. 'lpursell'  my user name, this works the best
  91. 'Lonny'     this works, but you might get a long list of Lonny's
  92.  
  93. ' @brutus.bright.net'   returns the users on the consoles
  94. (note the leading space is required)
  95.  
  96. ''  a blank line will also return the users on the consoles
  97.  
  98. If you are looking for 'Steve' you can simply enter 'Steve' and
  99. get a complete list all users with the name 'Steve'.
  100.  
  101. Keep in mind some servers return very little information while
  102. others return a lot.
  103.  
  104.  
  105. Support
  106. -------
  107. This program is FreeWare.  There is no fee required to use this
  108. software nor is anything disabled.  This is a fully functional
  109. program.  However, donations of will be accepted.
  110.  
  111. Contact:
  112.  
  113.   Lonny Pursell
  114.   101 1/2 S High Street  Apt C
  115.   Columbus Grove  OH  45830
  116.   USA
  117.  
  118.   E-Mail: lpursell@bright.net
  119.  
  120. When reporting bugs please include _detailed_ information about
  121. your system setup.
  122.  
  123.  
  124. Future Additions
  125. ----------------
  126. A hotlist in the form of a popup so one can store several finger
  127. addresses for quick access.
  128.  
  129. Recode the interface to run in a window.
  130.  
  131.  
  132. Credits
  133. -------
  134. Nicholas Flintham (aka Flinny) for sending me the STiK dev kit
  135. All the STiK beta testers  (you know who you are)  ;^)
  136. Ozzy Osbourne --> Ozzmosis <-- This album R-O-C-K-S !
  137. Steve Adam for introducing STiK to the world of Atari
  138. Dan Ackerman for having the nerve to follow in Steve's foot prints.
  139.  
  140.  
  141. Revision History
  142. ----------------
  143. [beta .01]
  144. It seemed to work ok on my system.  =)
  145.  
  146. [beta .02]
  147. If the FINGER.INF file is not found the program will fill in the
  148. cache path with the default path when the program was started.
  149. The program will fill in the server setting with the NAMESERVER
  150. tag returned by STiK if loaded and enabled.  If the NAMESERVER
  151. tag is not found then the server setting is left blank.  Likewise
  152. the finger setting will be filled in with the USERNAME tag if
  153. found.
  154.  
  155. The first beta allocated all free ram at startup!  It now only
  156. allocates about 32k for itself.  It dynamically allocates ram as
  157. needed based on how much data it has transfered from the server.
  158. If for some reason you get an out of memory error, you will not
  159. be able to view the results of the finger.
  160.  
  161. Tabs are now properly handled in the display area.  The progam
  162. currently has a fixed tab size of 8 chars.  This may have to be
  163. made configurable.  Do all servers use a tabs spacing of 8
  164. characters?  It's fixed at 8 chars until a bug report comes in I
  165. guess.  =)
  166.  
  167. Improved disk error handling when writing to the cache.  No one
  168. reported disk errors however it now handles write-protected and
  169. full disk errors properly.
  170.  
  171. Minor visual changes to the resource file were made.  I removed
  172. the subtitle and moved the server and cache setting to the bottom
  173. of the dialog.  The button spacing was adjusted to allow for the
  174. 3D effects.  This version will display 3D objects if your AES
  175. supports it.
  176.  
  177. [beta .03]
  178. Hopefully fixed a problem with mouse clicks and key presses
  179. bleeding through to the desktop on the Falcon.  Seemed to only
  180. happen with Multi-TOS loaded on my machine.  On machines without
  181. the fancy 3D effects the dialog now looks as it did before.  The
  182. minor problem with the finger input line not displaying
  183. characters properly is fixed.
  184.  
  185. [beta .04]
  186. Due to the way GEM interprets the '@' sign as a null it was not
  187. possible to finger something such as '@bright.net'.  As soon as
  188. you typed the '@' sign as the first character of the finger GEM
  189. grabs hold of it and messes things up.  To get around this I
  190. added a small work around.  To finger '@bright.net' you need to
  191. type ' @bright.net' instead.  Note the leading space.  The
  192. leading space is removed before the finger is sent to the server.
  193. Not the best fix, however it works.
  194.  
  195. [v1.00]
  196. First public release.  Beta .04 with a 1.00 version number.
  197.  
  198. eof
  199.